home *** CD-ROM | disk | FTP | other *** search
/ Aminet 7 / Aminet 7 - August 1995.iso / Aminet / comm / net / DialupV3_03.lha / dialup / dialup.doc < prev    next >
Text File  |  1994-10-17  |  27KB  |  769 lines
  1.  
  2.  
  3.                       Samson
  4.  
  5.                           offers:
  6.  
  7.  
  8.                  _____  _       _
  9.                 |  __ \(_)     | |
  10.                 | |  | |_  __ _| |_   _ _ __
  11.                 | |  | | |/ _` | | | | | '_ \
  12.                 | |__| | | (_| | | |_| | |_) |
  13.                 |_____/|_|\__,_|_|\__,_| .__/
  14.                                        | |
  15.                      Version 3.03      |_|
  16.                      ------------
  17.  
  18.  
  19.  
  20.  
  21.           PLEASE READ THE DOCS, DIALUP IP IS NO EASY THING!
  22.  
  23.     PLEASE TRY THE OPTION 'TEST', IT IS INCREDIBLY HELPFUL. YOU CAN
  24.     TEST EVERYTHING LOCALLY WITHOUT WASTING ANY MONEY ON PHONECALLS.
  25.  
  26.  
  27.          ITS NOT PUBLIC DOMAIN, ITS NO SHAREWARE, NO FREEWARE,
  28.           GIFTWARE OR CARDWARE AND HAS NO COPYLEFT OR -RIGHT.
  29.  
  30.              ITS SIMPLY A PROGRAMM TO USE, IF YOU LIKE.
  31.  
  32.              AND EVEN BETTER: IT NOW COMES WITH SOURCES!
  33.                (If you have troubles with the program,
  34.                 first take a look at the sourcecode.)
  35.  
  36.  
  37.  
  38.  P U R P O S E:
  39.  --------------
  40.  
  41.  This programm is intended to establish a dialup IP connection (SLIP or PPP)
  42.  to another computer. It is assumed that a modem or a similiar device is
  43.  connected to a serial line of your amiga. (An ISDNMASTER with approriate
  44.  device does work, too)
  45.  
  46.  
  47.  
  48.  R E Q U I R E M E N T S:
  49.  ------------------------
  50.  
  51.  - Installed and *tested* AmiTCP or AS225
  52.  - appropriate Sana2 Driver for your intended connection
  53.  - min. OS 2.04
  54.  
  55.  
  56.  
  57.  H O W   T O   B E G I N:
  58.  ------------------------
  59.  
  60.  To start, you should do the dialup manualy, first. If you have figured
  61.  out the commands for the modem and its results, and the questions of the
  62.  remote site and the expected answers, you can use dialup with the
  63.  appropriate options:
  64.  
  65.    LOGINPROMPT, LOGINNAME, PASSWORDPROMPT, PASSWORD, CONNECTSTRING, etc..
  66.  
  67.  A few of them are required, but most of them are optional and only neccesary,
  68.  if you have a strange modem or remotesite.
  69.  
  70.  To make small steps from the manual to the automatic dialup, you can
  71.  save your modem settings together with the phonenumber in the modem. If you
  72.  do this, you can already use the defaults for MODEMSETTINGSCONNECT=MSC (ATZ1)
  73.  and PHONENUMBER=PN (ATDS1). The modemcommands for saving config and
  74.  phonenumbers are:
  75.  
  76.     AT&Z1=xxxx and AT&W1 
  77.  
  78.  If you have configured dialup correctly (SANADEVICE=SAD and SANAUNIT=SAU),
  79.  the ONLINE and OFFLINE CLI-commands of the SANA-device are obsolete,
  80.  cause dialup handles this by itself.
  81.  
  82.  
  83.  N O T E S:
  84.  ---------
  85.  
  86.  The program is residentable (pure with the help of cres.o)
  87.  
  88.  HINT: To test the program, use the option TEST. This performs a modem
  89.  ====  internal loopback instead of a real CONNECT. You can see what will 
  90.        go on during CONNECT, HANGUP, etc..
  91.        With SLIP you can even ping yourself or ftp, etc..
  92.        THIS WORKS WITH AMITCP, TOO, IF YOU REMOVE THE ROUTE FOR 'OWNHOST' TO
  93.        THE LOOPBACKINTERFACE. USE: 'route delete <yourhostname>' or see the
  94.        script at the end of the docs!
  95.  
  96.  
  97.  S A V I N G   C O N F I G U R A T I O N:
  98.  ----------------------------------------
  99.  
  100.  It is possible to set any option in ENV:Dialup (Setenv Dialup "PASSWORD=ItsMe")
  101.  
  102.  BEWARE: ONLY the FIRST LINE gets parsed!
  103.  
  104.  To check the settings (from ENV:Dialup) and its parsing, use:
  105.  
  106.     'dialup DEfaults ALL'
  107.  
  108.  
  109.  
  110.  D E S C R I P T I O N   O F   P A R A M E T E R S:
  111.  ==================================================
  112.  
  113.  The template is:
  114.  
  115.  
  116.                 Dialup [COMMAND] [OPTIONS]
  117.  
  118.  
  119.   WARNING:
  120.   ========
  121.  
  122.    Please  note, that COMMAND is optional, too. This means, that if you accept
  123.    the default command (TOGGLE), any misspelled option gets the COMMAND instead
  124.    of the default one and probably pops up the usage requester. Every other
  125.    wrong  option  (or  even  the  first,  when you specified a COMMAND, gets a
  126.    PHONENUMBER.  This  is  not  my  fault, this is the documented behaviour of
  127.    dos.library/ReadArgs() on /M paramters.
  128.  
  129.  
  130.  
  131.  COMMAND=CMD
  132.  ===========
  133.  
  134.  The default is TOGGLE.
  135.  The command can be specified without keyword. The first word of the
  136.  commandline, which is not a keyword or switch of the template, is
  137.  taken as the command.
  138.  
  139.  After any successfully performed command the global environment varialble
  140.  'SLIPCARRIER' is set to 'ON' or 'OFF'.
  141.  
  142.  Possible commands:
  143.  
  144.  CONNECT=CO        Try to build a modem connection.
  145.                    Basically this performs:
  146.  
  147.                        ATZ1, ATDS1, <loginchat>, sana online
  148.  
  149.                    If you want to be sure, that the connection is
  150.                    established, when you start ftp or some other 
  151.                    networking stuff, write a script which calls
  152.  
  153.                        Dialup CONNECT QUIET
  154.  
  155.                    before the net application. QUIET suppress' the
  156.                    warning, if you are already connected.
  157.                    See 'C H A T   O P T I O N S' for the loginchat.
  158.                    Result: 1 if success, 5 if modem is already online
  159.  
  160.  HANGUP=HA         Break a connection. This even works during full
  161.                    data transfer. (Cause it sucks :-) the serial line)
  162.                    Basically this performs:
  163.  
  164.                        +++ ATZ1 sana offline
  165.  
  166.                    If you have a feed, which calls you when packets
  167.                    arrive, you will be called back. To make the modem
  168.                    take the call by itself, the NORECONNECT option must
  169.                    not be set.
  170.                    Result: 0 if success
  171.  
  172.  TOGGLE=TO         Toggles between CONNECT and HANGUP, depending on
  173.                    carrier
  174.                    Result: see CONNECT/HANGUP
  175.  
  176.  TAKE=TA           Sends a ATA\r (MODEMOFFHOOKCMD=MOH) to the modem
  177.                    after RINGS=RGS\K\N rings (MODEMRING=MRG\K) are
  178.                    detected and makes sana device online.
  179.                    If a carrier is detected on startup, only the sana
  180.                    device is made online.
  181.                    Result: 3 if success
  182.  
  183.  QUERY=QU          Querys the modem for some information, even when
  184.                    connected. This will work only with the NODTRIGNORE
  185.                    switch not set (or you configured the modem to
  186.                    ignore DTR anyway).
  187.                    Basically this performs:
  188.  
  189.                        sana offline  +++  ATI2  ATO  sana online
  190.  
  191.                    See MODEMQUERYCMD for the type of information
  192.                    gathered from modem. To get a nice status report from
  193.                    modem you could use:
  194.  
  195.                    > dialup QUery RePortFile "CON:100/100/400/200/..
  196.                                     ..Dialup Query/CLOSE/INACTIVE/WAIT"
  197.                    Result: 2 if success
  198.  
  199.  OFFLINE=OF        sana offline
  200.                    Result: 0 if success
  201.  
  202.  ONLINE=ON         sana online
  203.                    Result: 0 if success
  204.  
  205.  CARRIERDETECT=CD  sana offline, if no carrier and online if carrier.
  206.                    Meaningfull options: AUTOANSWER=AA and if this is 
  207.                    set RINGS=RGS and MODEMSETTINGSCONNECT=MSC
  208.                    Result: 0 if offline, 5 if online
  209.  
  210.  CHECK=CH          Possible at any time! It only sets a returncode:
  211.                    Result: 0 if no carrier, 5 if carrier
  212.  
  213.                    In addition to this the global environment variable
  214.                    'SLIPCARRIER' is set to 'ON' or 'OFF' after this and any
  215.                    other successfully performed command.
  216.  
  217.              Note:
  218.                    For checking the serial line without hitting
  219.                    the hardware directly, it is neccessary to
  220.                    offline/online the slip device to open the
  221.                    serial.device. This normaly doesn't disturb an
  222.                    ongoing transmission.
  223.  
  224.  DEFAULT=DE        Query any option for its default. Helpfull to see
  225.                    what will be sent to modem, and chated with your
  226.                    remote site. Use GIVEALLSETTINGS=ALL if you want
  227.                    to see all the default parameters (including
  228.                    ENV:DIALUP) or name a specific.
  229.  
  230.                        1> setenv DIALUP "MSC=ATsomething"
  231.                        1> Dialup DEFAULT MODEMSETTINGSCONNECT
  232.                        MODEMSETTINGSCONNECT=MSC/K: ATsomething
  233.  
  234.                    or 
  235.  
  236.                        1> Dialup DEFAULT GIVEALLSETTTINGS
  237.                        CONNECTSTRING=CS/F: 19200/V42b
  238.                        SANAUNIT=SAU/K/N: 0
  239.                        SANADEVICE=SAD/K: Networks/rhcslip.device
  240.                        NORECONNECT=NRC/S: OFF
  241.  
  242.                        [ .. ]
  243.  
  244.                        RINGS=RGS/K/N: 1
  245.                        MODEMCONNECTTIME=MCT/K/N: 40
  246.                        REDIALDELAY=RDD/K/N: 60
  247.                        PHONENUMBER=PN/K/M: ATDS1 
  248.                        MODEMSETTINGSCONNECT=MSC/K: ATZ1
  249.  
  250.  
  251.  O P T I O N S:
  252.  ==============
  253.  
  254.  General notes on paramters:
  255.  
  256.   - All options can be kept set for any of the above commands, but not all
  257.     have a meaning to a specific command.
  258.  
  259.   - To send special chars, use \n for LF, \r for CR and \t for TAB.
  260.     To send a single \ use \\.
  261.  
  262.   - For any expected string you can use patterns:
  263.  
  264.         Pattern Matches
  265.         ------- -------
  266.            ?    any single character
  267.            c*   zero or more occurrences of character c
  268.            c+   one or more occurrences of character c
  269.            \?   a question mark (?)
  270.            \*   an asterisk (*)
  271.            \+   a plus sign (+)
  272.       
  273.         Any other character must match exactly.
  274.         The following table lists some examples:
  275.  
  276.         Pattern Matches
  277.         ------- -------
  278.           abc   only abc
  279.           ab*c  ac, abc, or abbc
  280.           ab+c  abc, abbc, or abbbc
  281.           ab?*c a string starting with ab and ending in c, for
  282.                 example, abxyzc
  283.           ab\*c only ab*c
  284.  
  285.   - Multiple matching strings:
  286.  
  287.         If there is more than one possible string you can specify all
  288.         of them, sparated by '|'. To specify '|' use '?'.
  289.         Example:  MOK="OK|DONE" or MODEMLINEBUSY="NO CARRIER|BUSY"
  290.  
  291.     I thoght a long time about implementing the pattern matching
  292.     through dos calls, but the parsing and specifying of parameters
  293.     would have been a pain:
  294.  
  295.       (#?BUSY\n#?)|(#?NO CARRIER\n#?)|(#?CONNECT#?19200#?\n)|etc.
  296.  
  297.     Write me a mail, if you really would like to have it.
  298.  
  299.  
  300.  
  301.  B A S I C    O P T I O N S:
  302.  ---------------------------
  303.  
  304.  
  305.  PHONENUMBER=PN/K/M      The phonenumber(s!) to dial.
  306.                          If the parameter has a leading 'AT' or '!' no ATD
  307.                          is sent before the number. ('!' will be stripped)
  308.                          Default: S1                    -> ATDS1
  309.  
  310.                          Example: 1234                  -> ATD1234
  311.                                   ATDP1234              -> ATDP1234
  312.                                   !foobar               -> foobar
  313.  
  314.                                   pn S1 pn=S1 pn ATDP1234\
  315.                                            -> ATDS1 ATDS1 ATDP1234
  316.                                  If the call fails with BUSY, it would wait
  317.                                  the REDIALDELAY and try again. If this
  318.                                  fails, too, it immediately trys 1234.
  319.  
  320.                 Warning: Everything what cannot be identifyed as an option
  321.                 =======  or a COMMAND will get a phonenumber. This is not
  322.                          my fault, this is the documented behaviour
  323.                          of dos.library/ReadArgs() on /M paramters.
  324.  
  325.  
  326.  SANADEVICE=SAD/K,       Sana device to use. You have to specify
  327.                          'Networks/yoursana.device', if it is in DEVS:Networks.
  328.                          Default: "NetWorks/rhcslip.device"
  329.  
  330.  
  331.  SANAUNIT=SAU/K/N,       Sana unit to use.
  332.                          Default: 0
  333.  
  334.  
  335.  SANACONFIGFILE=SCF/K,   Config file of the sana device. It must match:
  336.  
  337.                          "SERNAME/A,SERUNIT/A/N,SERBAUD/A/N,IPSTR/A,..
  338.                          ..CD=CARRIERDETECT/S,7WIRE/S,EOFMODE/S,MTU/K/N,THEREST/F   
  339.  
  340.                          Examples:
  341.  
  342.                               ppp%d.config, ppp0.config, sys:devs/myconfig
  343.  
  344.                          Default: "ENV:SANA2/slip0.config"
  345.                          (This file gets read by *any* slip device)
  346.  
  347.  
  348.  REDIALDELAY=RDD/K/N     Seconds to wait after a BUSY (MLB\K) before calling
  349.                          the *same* number(s) again. If you specify 0 it will
  350.                          NOT retry on BUSY.
  351.                          Default: 180
  352.  
  353.  
  354.  RINGS=RGS/K/N           Number of rings to wait before the modem should
  355.                          take an icomming call. This takes effect only
  356.                          after a HANGUP or CARRIERDETECT with AUTOANSWER!
  357.                          With the TAKE command this in the number of RINGs
  358.                          to receive from the modem, before takeing the
  359.                          call. For TAKE it is possible to specify 0.
  360.                          Default: 1
  361.  
  362.  
  363.  
  364.  O P E R A T I N G   M O D E S:
  365.  ------------------------------
  366.  
  367.  
  368.  AUTOANSWER=AA/S         Take any incomming call after HANGUP, sana stays
  369.                          online. The parameter RINGS tells the modem how
  370.                          many rings it should wait before offhook.
  371.                          Default: OFF
  372.  
  373.  
  374.  NODTRIGNORE=NDI/S       Disable the sending of AT&D0 to the modem before a
  375.                          CONNECT and AT&D2 after HANGUP. Normaly AT&D0 is
  376.                          necessary, to not drop the line befor makeing
  377.                          sana online.
  378.                          Default: OFF
  379.  
  380.  
  381.  NOSERINIT=NSI/S,        To avoid initialisation of serial line with the
  382.                          parameters from 'ENV:SANA/slip0.config' (in fact
  383.                          SANACONFIGFILE=SCF/K; it is read anyway, to get
  384.                          the device(name) to open)
  385.                          Default: OFF
  386.  
  387.  
  388.  NORECONNECT=NRC/S,      No autoanswer during CONNECT (e. g. carrier lost,
  389.                          remote site calls back).
  390.                          Modem takes phone after first ring until you do
  391.                          a HANGUP without AutoAnswer.
  392.                          Default: OFF
  393.  
  394.  
  395.  
  396.  
  397.  R E P O R T   A N D   D E B U G   O P T I O N S:
  398.  ------------------------------------------------
  399.  
  400.  
  401.  CONNECTSTRING=CS/K      This string is expectd as the connectstring from
  402.                          the modem. If its not found, a requester pops
  403.                          up, telling you the actual connect message.
  404.  
  405.                          If you specify CONNECT you will never see a
  406.                          requester(If your modem gives at leas this answer
  407.                          for a connect).
  408.  
  409.                          With this parameter it is possible to use patterns.
  410.                          See top note for information on patterns.
  411.                          Default: "CONNECT*?19200/V42b"
  412.  
  413.  
  414.  REPORTFILE=RPF/K        Where to put the report of the serial communication.
  415.                          Note: I've never observed that dialup looses *ANY*
  416.                          character. If you have troubles with the serial
  417.                          communication, it is sometimes helpfull to send
  418.                          the output to a file and view it with:
  419.  
  420.                              1> type <reportile> hex
  421.  
  422.                          Another good use is to specify a window like
  423.  
  424.                          RPF="CON:100/100/400/200/Dialup/CLOSE/INACTIVE"
  425.  
  426.                          When you press the (toolmanager) hotkey to start
  427.                          dialup, you can see whats going on. If there is no
  428.                          error, it is closed after successful connection. If
  429.                          an error occours, and you started it with '< NIL:'
  430.                          somehow, a requester pops up, telling you the failure.
  431.                          But during this time the RPF window keeps open and you
  432.                          can examine every detail of the report. I realy like
  433.                          this!
  434.                          Default: stdout
  435.  
  436.                          
  437.  QUIET/S                 Be quiet to stdout and suppress all non fatal messages.
  438.                          Default: OFF
  439.  
  440.  
  441.  STDEER/S                No requesters anymore. Errors and warnings are sent
  442.                          to '*' (console) as long as '*' could be opened and
  443.                          even if there is an interactive inputstream
  444.                          (e.g. shell) for the program.
  445.                          Default: OFF
  446.  
  447.  
  448.  VERBOSE/S               Reports all internal function calls with strings sent
  449.                          to serial line and all expected returns. To avoid
  450.                          intermixing these messages with the serial
  451.                          communication itself, a console widow gets the
  452.                          default for RPF.
  453.                          Default: OFF
  454.  
  455.  
  456.  TEST/S                  This is a very helpfull option. Instead of dialing
  457.                          a number, it does AT&T1. This is a modem internal
  458.                          loopback mode. This enables you to do a ping to
  459.                          yourself *over* the modem. You can even do a ftp to
  460.                          your machine and check the max. transmission speed.
  461.                          After this you can QUERY the modem and look for any
  462.                          errors. This is true for AmiTCP, too. See script at
  463.                          the end. The tcp-test (ping, etc.) is not possible
  464.                          with ppp, however, cause it uses a more complicated
  465.                          transmission concept and doesn't accept this simple
  466.                          loopback.
  467.                          Default: OFF
  468.  
  469.  
  470.  GIVEALLSETTIGNS=ALL/S   This switch is only valid with the DEFAULT command!
  471.                          It shows all current defaults. ENV:Dialup takes
  472.                          effect!
  473.  
  474.  
  475.  
  476.  C H A T   O P T I O N S:
  477.  -----------------------
  478.  
  479.     Note:   The sequence of the chat after CONNECT is:
  480.     =====
  481.             - [Wait and] Send WAKEUPSTRING
  482.             - Wait for LOGINPROMPT
  483.             - Send LOGINNAME or $HOSTNAME.
  484.             - Wait for PASSWORDPROMPT, if not ""
  485.             - Send PASSWORD
  486.             - IF SNDLOGINNAME specified, wait for SNDLOGINPROMPT
  487.             - IF SNDLOGINNAME specified, send     SNDLOGINNAME
  488.             - IF SNDPASSWORD  specified, wait for SNDPASSWORDPROMPT
  489.             - IF SNDPASSWORD  specified, send     SNDPASSWORD=SPW
  490.             - Wait for LOGINOK=LOK if not ""
  491.  
  492.  
  493.  WAITBEFORWUS=WBW/K/N    Seconds to wait befor sending WUS
  494.                          Default: 3
  495.  
  496.  WAKEUPSTRING=WUS/K      String is sent after connect, before 'ogin:' (LIP)
  497.                          is expected. Remember:
  498.                          Use \n for LF, \r for CR and \t for TAB.
  499.                          To send a single \ use \\.
  500.                          No default.
  501.  
  502.  
  503.  
  504.  LOGINPROMPT=LIP/K       Prompt of the remote site to enter your name.
  505.                          To skip login and password communication use
  506.                          LIP="".
  507.                          Default: "ogin:"
  508.  
  509.  
  510.  LOGINNAME=LIN/K         Name to send after receiving the LOGINPROMPT. If
  511.                          not specified, it will be taken from the environment
  512.                          variable HOSTNAME.
  513.                          No default. (or ${HOSTNAME})
  514.  
  515.  
  516.  LOGINTIMEOUT/K/N        Seconds to wait for the loginprompt of the remote
  517.                          site.
  518.                          Default: 3
  519.  
  520.  
  521.  
  522.  
  523.  PASSWORDPROMPT=PWP/K    Prompt of the remotesite to enter your password.
  524.                          With this parameter it is possible to use patterns,
  525.                          too. See LOGINPROMPT=LIP
  526.                          To skip password communication use PWP="".
  527.                          Default: "assword:"
  528.  
  529.  
  530.  PASSWORD=PW/K           String to send after the PASSWORDPROMPT is received.
  531.                          No default.
  532.  
  533.  
  534.  
  535.  
  536.  SNDLOGINNAME=SLIN/K     This gets sent, if specified at all, after receiving
  537.                          what is set for                     (no default)
  538.  
  539.  
  540.  SNDLOGINPROMPT=SLIP/K   Default: ogin:
  541.  
  542.  
  543.  SNDPASSWORD=SPW/K       This gets sent, if specified at all, after receiving
  544.                          what is set for:                     (no default)
  545.  
  546.  
  547.  SNDPASSWORDPROMPT=SPWP/K Default: "assword:"
  548.  
  549.  
  550.  
  551.  
  552.  LOGINOK=LOK/K,          Message of the remote site after succesfull login.
  553.                          Use LOK "" to skip this check.
  554.                          Default: "Packet mode enabled"
  555.  
  556.  
  557.  LOGINOKTIMEOUT=LOT/K/N  The timeout (in seconds) for the answer (LOK) to a
  558.                          successfull login.
  559.                          Default: 3
  560.  
  561.  
  562.  
  563.  M O D E M   A D J U S T M E N T:
  564.  -------------------------------
  565.  
  566.  MODEMSETTINGSCONNECT=MSC/K  Command string to send to the modem before 
  567.                          any attempt to connect. If you don't want to
  568.                          send something use MSC ""
  569.                          Default: ATZ1
  570.  
  571.  
  572.  MODEMCONNECTTIME=MCT/K/N  The time in seconds, the modem needs to dial and
  573.                          handshake with the remote site.
  574.                          Default: 61
  575.  
  576.  
  577.  MODEMSETTINGHANGUP=MSH/K Command string to send to modem after HANGUP.
  578.                          To avoid this completely use MSH "".
  579.                          Default: ATZ1
  580.  
  581.  
  582.  MODEMQUERYCMD=MQC/K     Hayes commands to query modem. This command is sent
  583.                          to the Modem to query the modemstatus ( or
  584.                          anything else you want to know ).
  585.                          You even can change the configuration of the
  586.                          modem, during it is online.
  587.                          Default: AT&VI2
  588.  
  589.  
  590.  MODEMREADYCMD=MRC/K     Command, the modem answers with MODEMCMDOK=MOK/K (OK)
  591.                          Default: AT
  592.  
  593.  
  594.  MODEMHANGUPCMD=MHC/K    Command to make the modem drop line.
  595.                          Default: ATH0
  596.  
  597.  
  598.  MODEMNOCARRIER=MNC/K    Answer of modem on failed CONNECT
  599.                          Default: NO CARRIER
  600.  
  601.  
  602.  MODEMLINEBUSY=MLB/K     Message of modem when line busy.
  603.                          Default: BUSY
  604.  
  605.  
  606.  MODEMLINEDEAD=MLD/K     Message of modem when it doesn't get a dialtone.
  607.                          Default: NO DIALTONE
  608.  
  609.  
  610.  MODEMRING=MRG/K         Message of modem when a call comes in.
  611.                          Default: RING
  612.  
  613.  
  614.  MODEMANYCONNECT=MAC/K   Message of modem if a connection of any kind has been
  615.                          established.
  616.                          Default: 'CONNECT?*'     (see LOGINPROMPT)
  617.  
  618.  
  619.  MODEMCMDOK=MOK/K        Answer from Modem if command is ok.
  620.                          Default: OK
  621.  
  622.  
  623.  MODEMAACMD=MAAC/K       Make modem take phonecall after RINGS=RGS/K/N
  624.                          Default: ATS0=%d
  625.  
  626.  
  627.  MODEMOFFLINECMD=MOC/K   Make modem accept commands again (offline)
  628.                          Default: +++
  629.  
  630.  
  631.  MODEMONLINECMD=MLC/K    Bring modem online again
  632.                          Default: ATO
  633.  
  634.  
  635.  MODEMTESTCMD=MTC/K      modem to internal loop-back mode
  636.                          Default: AT&T1
  637.  
  638.  
  639.  MODEMOFFHOOKCMD=MOH/K   make modem off hook and answer the call.
  640.                          Default: ATA
  641.  
  642.  
  643.  MODEMTESTOFFCMD=MTO/K   switch of  modem loopback
  644.                          Default: AT&T0
  645.  
  646.  
  647.  MODEMCMDOK=MOK/K        Answer from Modem if command is OK
  648.                          Default: OK
  649.  
  650.  
  651.  
  652.  A d d i t i o n a l   n o t e s:
  653.  --------------------------------
  654.  
  655.   The stackusage is about 3000 Bytes and the memoryusage is less
  656.   than 30K Bytes.
  657.  
  658.   As long as dialup is started from a console (input not NIL:), the
  659.   program messages and the input from the serial line are sent to it.
  660.   If you start it without console, but don't want to see any requester,
  661.   use option STDERR.
  662.  
  663.   If you use VERBOSE, a default window is opened for the serial
  664.   input. You can override this by specifying RPF CON:////dialup..
  665.  
  666.   The best use for this program is to make it startable with a hotkey.
  667.   (e.g. ToolManager) Commandline:
  668.  
  669.       'Dialup REPORTFILE T:dialup.report'.
  670.  
  671.   Think about making it resident, if you can afford the memory.
  672.  
  673.   To stop the program at ANY time press ^C in the shell or start it a second
  674.   time. If you start the program a second time ( e.g. after a BUSY, waiting
  675.   for the REDIALDELAY ) it sends a ^C to its first occurence.  So, if you
  676.   have the programm bound to a hotkey, just press it again to stop the
  677.   (re)dialing.
  678.  
  679.   To reset the modem I use:
  680.  
  681.       'Dialup HANGUP NODTRIGNORE MODEMSETTINGSHANGUP ATZ'
  682.  
  683.   or short:
  684.  
  685.       'Dialup ha ndi msh atz'
  686.  
  687.   To get a system, taking incomming calls after every reboot, add
  688.  
  689.       'Dialup CARRIERDETECT AUTOANSWER QUIET RINGS=n'
  690.  
  691.   to your user-startup. But this only works if no programm is
  692.   causing slip packets beeing sent to the modem, otherwise the
  693.   modem connect could get disturbed.
  694.  
  695.  
  696.   I always load the whole network sw in user startup:
  697.  
  698.    AS225:
  699.    ------
  700.  
  701.     8<------------------------------------------
  702.       INET:c/config > ENV:HOSTNAME HOSTNAME
  703.       INET:c/config > ENV:USER USER
  704.       INET:c/ifconfig lo0 127.1
  705.       INET:c/ifconfig s0 $hostname -trailers
  706.       INET:c/Route add default <yourslipsite> 0
  707.  
  708.       Dialup CARRIERDETECT
  709.  
  710.       IF WARN
  711.           Ping <yourslipsite>
  712.           IF NOT WARN
  713.               Say "Connected to Intearnet"
  714.           EndIF
  715.       EndIF
  716.   8<------------------------------------------
  717.  
  718.  
  719.    AmiTCP:
  720.    -------
  721.  
  722.     8<------------------------------------------
  723.       Run < NIL: > NIL: AmiTCP:AmiTCP
  724.       WaitForPort AMITCP
  725.       Wait 2 secs
  726.       RX "ADDRESS AMITCP;'SET CON NIL:'" ; stops this 'slip.device online/offline' messages.
  727.  
  728.       AmiTCP:bin/ifconfig lo/0 localhost
  729.       AmiTCP:bin/ifconfig Devs:Networks/rhcslip.device/0 xxx.yyy.zz.uuu aaa.bbb.ccc.ddd netmask 255.255.255.0
  730.     
  731.       ;AmiTCP:bin/route add troja.mppmu.mpg.de localhost ; remove to enable ping over modem!
  732.       AmiTCP:bin/route add default 134.107.2.51
  733.       AmiTCP:bin/route add 134.107.2.6
  734.  
  735.       Run < NIL: > NIL: AmiTCP:bin/inetd
  736.       Mount TCP:
  737.  
  738.       Dialup CARRIERDETECT
  739.  
  740.       IF WARN
  741.           Ping <yourslipsite>
  742.           IF NOT WARN
  743.               Say "Connected to Intearnet"
  744.           EndIF
  745.       EndIF
  746.     8<------------------------------------------
  747.  
  748.  
  749.  Then simply start dialup anytime later and you get connected.
  750.  
  751.  
  752.  Have fun! Questions and bugreports (?? :-) to:
  753.  
  754.              Thomas Kobler
  755.              Libellenstr. 29
  756.              80939 München
  757.              Germany
  758.  
  759.              kobler@mpiw13.mppmu.mpg.de
  760.              +49 89 3241329 (and +49 89 32308311 at work)
  761.              try to 'talk' to me at samson@troja.mppmu.mpg.de or 
  762.                              (kobler@pctok.mppmu.mpg.de at work)
  763.  
  764.  
  765.   After all the time I spent on this stuff, I feel that it would be nice, if
  766.   you would send me something: ranging from an email over nice gifts to
  767.   some financial donations. Its up to you.
  768.  
  769.